COLOR GRAPHICS FOR THE APPLE II 


with 


ROG ER’S EASEL by Roger Wagner 


A paddle oriented color sketch program using lo-res graphics 


At last a program which allows you to draw color pictures in lo-res graphics, and then permanently link 
them to your own seger or Applesoft programs. Linked re can be displayed on either text/graphics 
page. 


included in this set is: 


ROGER’S EASEL: An easy to use color sketch program to create the highest quality lo-res pictures 
| possible, and then easily save them to disk or tape. 


LO-RES LINK: The most outstanding feature of this package. The ‘LINK’ programs allow you to 
take previously stored lo-res graphics (or even text) pages, and selectively attach 
_ them to your own Integer or Applesoft programs. That’s right! Up to 40 pictures 
can be permanenily linked for nearly instantaneous (up to 10 pictures per second!) 
recall to the screen. 


Besides being just plain fun, applications range from putting more creative screen images in your game 
programs to educational programs for younger children involving shape or color recognition. It is also a great 
tool for making up demo programs for business as well as game programms. 


Program set includes: ROGER’S EASEL, LO-RES LINK-INTEGER, and LO-RES LINK-APPLESOFT. 
(Diskette version also includes several demonstration programs.) ROGER’S EASEL and LO-RES LINK- 
INTEGER are in Integer BASIC and will run ona 16K system. The Applesoft LINK program runs in Applesoft 
and requires a 24K system. 


Please specify diskette or tape. 


(Calif. residents add 6%) 


Available from local computer stores or: 


Southwestern Data Systems 
P.O. Box 582 
Santee, CA 92071 
(714) 562-3670 


(Dealer inquiries invited) 
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ROGERS BASEL 


REFERENCE MANUAL 


Copyright (c) 1979 by Roger Wagner and 
Southwestern Data Systems. All rights 
reserved. This document, or the software 
Supplied with it, may not be reproduced 
in any form or by any means in whole or 
in part without the prior written consent 
of the copyright owners. 


SOUTHWESTERN DATA SYSTEMS 
P.O. Bok 5302 
santee, Ca ..92071] 
(714) 562-3670 
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DISCLAIMER 


Southwestern Data Systems and program author shall have no liability 
or responsibility to purchaser or any other person or entity with 
respect to any liability, loss or damage caused or alleged to be 
caused directly or indirectly by this software, including but not 
limited to any interruption of service, loss of business or anticipa- 
tory profits or consequential damages resulting from the use or oper- 
ation of this software. | 


ROGER'S EASEL 


Purpose and Use 


This program allows you to sketch pictures in low-resolution 
graphics using the game paddles. It was designed to be as easy to use 
as possible, and still have every capability you would expect from the 
Apple II. 

You are urged to try and experiment with each feature as it is de- 
Scribed, to familiarize yourself with the many options available. 


To run the program, just "LOAD" and "RUN" in the normal manner. 
(Before running any other program, however, you may wish to re-initialize 
your system with a "RESET", “Control-B", as the "EASEL" will leave 
LOMEM: at 3972 and HIMEM: at 16384.) Note: If you have a disk, typ- 
ing in "INT" will accomplish the same result as a "RESET", “Control-B". 


In general, the two paddles alone will suffice to draw most of your 
pictures. Paddle J controls the horizontal (x) position of the cursor. Pad- 
dle 1 controls the vertical (y) position. Only when you press the button 
on Paddle @ will the cursor color be plotted on the screen. To draw lines, 
just hold the button down continuously while you move the paddles. To 
change color, press the button on Paddle l. 

To erase a given point or clear the screen entirely, you will need to 
use the keyboard. 

To clear the screen to black, press the "ESCAPE" key. To erase, 
first press the "E" key. The cursor will now be black (or whatever your 
background color is). Press the button on Paddle ®@ whenever the cursor 
is positioned over a spot to be erased. The erase is accomplished by 
plotting the background color at that spot. (If you wish to erase a large 
area, pressing the "P" key will start the continuous plot mode. The cur- 
sor will plot continuously until the space bar is depressed. This is also 
useful when you're not in the "Erase" mode.) 

When you're done erasing, just press the "R" (for "Restore") key. 
The cursor will return to the color you were originally drawing with. 


These are the fundamental functions. There are a few others, now- 
ever, which will make the drawing of pictures on your Apple II easier and 
much more fun. This list may be accessed at any time during the program 
by pressing the."H" (for "Help") key. When viewing the help list, the 
right arrow key will scroll the screen up to display the next line of text. 
By holding the right arrow and repeat keys down together, you may quickly 
scan down the list. To scroll up, use the left arrow key. 


You may also move up or down one complete page for each keystroke 
by uSing the "L" and ";" keys. When these are used with the repeat key 
you can move very quickly to any part of the help list. 

You will notice the "L" and ";" keys are located to the very left of 
the left and right arrow keys and act in an analagous way. This will help 
you remember how to make use of them. 


Below is the complete list of commands available during the opera- 
tion of "ROGER'S EASEL", followed by detailed explanations of each of the 
commands. 


COMMAND LIST 


ESC --~ Clear screen 

SW — Plot cursor color 

SW1 -- Change color 
B -- Set background color (erases current picture) 
C -- Set erase color to SCRN (x,y) 
H -- Help (this list) 


E -- Erase (and store cursor color) 

R -- Restore color used before erase 

S -- Store cursor color for later use 

X -- Extract that color (which was previously stored) 
P -- Continuous plot mode (space bar to clear) 

? -- Set cursor color to SCRN (x,y) 

L -- Load previously saved picture from tape 

T -- Save present picture to tape 


G-- Get previously saved picture from disk 

D -- Save present picture to disk 

N -- Numeric screen information toggle 

QO -= Quit program 

V -- View picture without text 

€ -- (Left arrow) Decrement color value by one 
(except when in "Help" section) 

>-- (Right arrow) Increment color value by one 
(except when in "Help" section) 


ESC => 


SW -- 


SWi == 


Detailed Explanations 


The escape key will clear the screen to black and reset the 
color used when erasing to black. 


Pressing the button on Paddle # will plot your present cursor 
color on the screen only as long as you are pressing the button. 


Pressing the button on Paddle 1 will add 1 to the present color 
value. At "15" it will change back to "9" (black). 


This key will clear the screen to a background color equal to 
whatever the present color of the cursoris. It also sets the 
erase color to that background color. 


If you have loaded a previously drawn picture, you can use 
this to set the color used during an erase to whatever you 
think most useful. To set it, position the cursor over the 
color on the screen you wish to set the erase colorto. Then 
press the "C" key. Color is now set. It may be reset at-any 
time by repeating this process. 


Pressing this key will deliver you to a program-contained copy 
of this text. To get back to your picture, press any key other 
than the two arrow keys and "L" and ";". 


Pressing this key will store the color you're presently using 
(you will see it appear in the space labeled "R"') and sets the 
cursor color to the present background color. Then start plot- 
ting with either the Paddle # button or the "P" key. Since you 
are plotting the background color it will erase whatever the 
cursor copies over. When you are done erasing , press the "R" 
key (for "Restore") and the cursor will return to the color you 
were uSing before the erase. 


This key will take whatever color is in the space labeled "R" 
on the screen and set the cursor color to that. It is usually 
used after an "erase", but can be used to temporarily store a 
color by using the "E" key followed immediately by the "R". 
The cursor color will remain stored in the "R" space to be re- 
trieved later with another "R" command. 


This is used to store the present cursor color for later use. 
The value will be displayed in the space labeled "X". It does 
not effect the cursor. At any time after the "store" the color 
may be retrieved by pressing the "X" (for "extract") key. 


X-- 


L-c- 


Ge-s 


As mentioned above, this will set the cursor color to whatever _ 
value has been previously stored by use of the "S" command. 


Pressing the "P" key will set the computer into the continuous 
plot mode. It will plot all points traced by the cursor until 
another key is pressed. You cannot change colors or execute 
other commands without turning off this mode. 


Entering a "?'" asks the computer to set the cursor color to 
whatever the color at that position on the screen currently is. 
This is a way of using colors you can see on the screen with- 
out having to use the arrows or SW1 to change the color one 
step ata time. 


After pressing this key, the Apple will tell you to load a pic- 
ture from tape. (Of course it helps to have already saved 
one .. .) Start the recorder in the "PLAY" mode and press 
"RETURN". The usual screen display will return when the 
loading is complete. 


To save a picture to tape, press the 'T". Then press the 
"PLAY" and "RECORD" buttons on your recorder, and press 
"RELURN” . 


This command gets a previously stored picture from disk. 
When it asks, enter the name you stored the picture under. 


To save a picture to disk, press "D" and when asked, enter 
the name you want the picture on the screen to be stored under. 
Any previous picture stored under that name will be lost. 


This key will switch back and forth between the normal screen 
data display and a special numeric output, each time the "N" 
key is pressed. All other commands function in either mode. 
The numeric mode gives the x and y position of the cursor, and 
the color already on the screen at that point. A "*" will appear 
when either paddle is about to switch to the next x/y increment. 
To avoid having a plot leave an erratic line, try to make sure 
an asterisk is not present on the paddle being held constant. 


This key will end the program, leaving the picture in tact. 
Type in "TEXT" to retum the screen to the normal format. 


Pressing "V" will temporarily eliminate the text at the bottom 
of the screen and allow you to view the picture without text, 
and as it will be saved. Pressing any key will return you to 
normal operation. 


on 


<— -- (Left arrow) Each time you press the left arrow key, the cursor 
color value will decrease by one. If the value is "9" decreasing 
it Will viela a “IS. 


— -- (Right arrow) Same as the left arrow, but increases the color 
value by one each time. If the value is "15" increasing it will 
yield "8", 


How [t Works 


Figure l 
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Most of the program is self-documenting internally as far as the 
actual sketching routines. All the graphics are displayed on page l 
(S498 to S7FF) as is usual for the Apple II. When you press the "H" key, 
a POKE-16299, switches the display to text/graphics page 2 (S89 to 
SBFF). At this point the binary text data stored at the end of the "Easel's" 
BASIC program space is loaded into the memory range of page 2. This 
binary data has been appended to the end of the program in the manner of 
any machine language routines, i.e. advancing the end-of-program pointers 
at 76 and 77 (decimal) to make room for the data to be stored. The two 
programs included with the "Easel" make use of this same technique to 
store lo-res pictures drawn earlier. 

The machine language routine is a re-write of the routines found 
in the red Apple II Reference Manual, specifically the SCROLL routine 
at SFC7 (pg. 84). The only alterations were to make the scrolling occur 
on pg. 2 of text/graphics, and to allow it to scroll both up and down. 


NOTE: For an interesting experiment, you can delete line 385 be- 
fore running the program. Graphics commands like "PLOT" have meaning 
even if you're not in the "GR" mode! ; 
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The "Easel" will greatly increase the types of lo-res graphics 
which you can incorporate into your own programs. Any number of com- 
pleted pictures can be directly linked to a program and selectively re- 
trieved with a simple "GOSUB" command. 

Typical uses include more detailed images for use in game pro- 
grams, and educational programs for younger children such as shape or 
color recognition. 


Simple animation can be done by successively displaying slightly 
different images on the screen. A sample Integer Basic program is given 
below. Be sure to set LOMEM: to 3872 before "KRUN"ning the program. 
(Or you may do it on the first line of the program if you are familiar with 
the technique.) 


18 GOSUB 32756: REM SET + OF PICS IN STORAGE 

28 PAGE=2: PIC=PIC+1: IF PIC NP THEN 99 

39 GOSUB.32757: REM LOAD PIC ONTO PG. 2 

46 POKE-16299,8: REM SWITCH TO DISPLAY PG. 2 
58 PAGE=1: PIC=PIC+1: IF PIC NP THEN 99 

68 GOSUB 32757: REM LOAD PIC ONTO FG, 1 

76 POKE -16388,8: REM SWITCH DISPLAY TO PG. l 


88 GOTO 22 
99 POKE -16388,8: REM RESTORE DISPLAY TO PG, 1 
108 END 


32756+ (LINKED PICTURES & RETRIEVAL ROUTINE) 


Each picture is loaded while the user is viewing the alternate 
page. 


In Applesoft, use of page 2 of text/graphics is difficult. With 
the cassette loaded version, use of page 2 is impossible pecause the 
interpreter itself resides here. With the ROM card version, two POKES 
must be done before the program can be LOADed and RUN. These are: 


POKE 14, 12: POKE 372,28 


If the program is being loaded from tape or DOS 3.1 you must then 
do a CALL 54514 before running the program. DOS 3.2 will do this auto- 
matically. The POKE to 184 moves the beginning-of-program pointer up 
in memory so that the program loads in above pg. 2. The above program 
will work in Applesoft, the only difference being that 63886 is the line 
equivalent to # 32756 in the Integer version, and 63891 equivalent to 
S27 54 « 


To see how to actually link created pictures to your programs, 
read the following documentation of the Lo-res Link programs. 


Please feel free to use the retrieval routines and linked pictures 
in any program you may wish to market commercially. Acknowledge- 
ment of the source would be appreciated, but not required. 


LO-RES PICTURE LINK --- INTEGER 


After saving any number of pictures to tape and/or disk using 
Roger's Easel, they may be selectively collected and appended onto 
another program of your own. If the program is in Integer Basic, use 
the Lo-Res Picture Link -- Integer program. This is the second program 
on the cassette. It is preceded by two tones for identification. The 
third program on the tape is the Lo-res Picture Link -- Applesoft pro- 
gram. [tis for linking pictures to Applesoft programs of your own and 
is preceded by 3 tones. 


To use the Integer Link program, just "LOAD" and "RUN" it as 
you would any program. The title banner should appear. Pressing any 
key will display the command list. 

The first step is to collect the series of pictures you wish to 
link to your program into one group. To begin the addition process, en- 
ter "A" and press "RETURN". This puts you in the picture addition rou- 
tine. You may add pictures from tape or disk. To end the process, enter 
"2" for the number choice. 

You may exit this routine to view the pictures collected thus far. 
After entering "2" you should be back at the command level. Entering a 
"V" will clear the screen and you will be asked which picture of the ones | 
presently stored you wish to view. Entering a "99" will allow you to 
view all the pictures sequentially, anda "0" will exit the viewing mode. 

You may alternate between viewing and the addition process as much 
as you wish. 

After you have assembled the series of pictures that you want in 
your final program, enter "L" (for Link) as the command. The program 
will delete all of itself except for the part that recalls the stored pic- 
tures. Then just "LOAD" your program and copy over the POKEs dis- 
played on the screen using the right arrow. At that point your program 
now containing the stored pictures and retrieval routine may be perma- 
nently saved. 

If for some reason you must stop the addition process for an ex- 
tended time, the program may be saved to tape or disk. DO NOT save 
it on top of, or under the same name as your purchased version! 


Once linked to a program, the pictures and retrieval routines may 
be removed by entering this line into the listing: 


32088 POKE 76, PEEK(22): POKE 77, PEEK(221): END 


A "RUN" or "GOTO" to this line will cause everything including 
and after that line to be removed from the listing, including the stored 
pictures. 

Note: This technique will work in any Integer program, which 
you may find useful for salvaging programs where a part of the listing 
at the end has become garbaged due to dropped bits or other mysterious 
happenings. 

After you have linked pictures to your program, disregard the seem- 
ingly unintelligible listing after line #32767. This is the binary data of 
the stored pictures. This will not be present in Applesoft program listings. 


To recall pictures to the screen, you need only specify the variable 
"DIC" equal to the number of the individual picture you wish to retrieve. 
Then (assuming you're already in the graphics mode} a GOSUB 32756 will 
display the picture. The only requirement is that a GOSUB 327595 must 
be done sometime prior to the retrieval. (This subroutine sets NP equal 
to the number of pictures stored). This need only be done once early in 
the program, providing of course that NP is not reset by another routine 
somewhere. 

If you want to have a picture displayed on page 2 of text/graphics, 
set the variable "PAGE" equal to 2. (It normally defaults tol). 

A sample program using just page 1 is given below: 


18 GR: GOSUB 32756: REM SET NP = # OF PICS STORED 
26 CALL -936: PRINT"PICTURE # TO VIEW? (";NP;" IN 
MEMORY)": INPUT PIC 
30 IF PIC<l THEN END: IF PIC)NP THEN 28 
46 GOSUB 32757 
58 GOTO 20 
32756+ (PICTURES & RETRIEVAL ROUTINES) 


Providing the basic logic of operation is maintained, the variable 
names used in the retrieval routines may be changed to prevent conflict 
with variable names in your Own program. You may want to examine 
lines 380 to 39M in the "Link" program, as they contain the sub-routine 
for picture retrieval in that program. 


How It Works 


Figure 2 
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In Integer Basic, a program normally sets at the upper range of 
memory, with the end of the program at the HIMEM: value (usually the 
top of the system's available memory). Variables are stored starting at 
memory location $889 (2848 decimal).and go up from there. The space 
in between the end of the variables and the beginning of the program is 
the available free space. (See figure 2). 
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In the "Link" program HIMEM: is set artificially low to 7428 when 
it is first "RUN". This leaves just enough room below it for the variables 
it uses and makes a great deal of memory above it available for storing 
picture data. (See fig. 3). Each time a picture is added, it is loaded at 
the end of the program, and then the end-of-program pointers (76 & 77 
decimal) are reset to include the new data. 

The data at the end of the program will not "LIST" out in any logi- 
cal pattern, but it will "SAVE" and "LOAD" right along with the Basic 
program itself. 


When the "Link" operation occurs, most of the program is deleted, 
and your program loaded in from about $17BM% (6864 decimal) on down. How 
many pictures you can add to your program depends upon the memory size 
of the system and whether or not you are using a disk. (DOS takes up 
18K of RAM). Do not attempt to add more pictures than are indicated by 
the chart below: 


10 


Memory Tape Disk 
16K 9 none Note: Subtract 10 from each value 
32 25 14 for the Applesoft Link pro- 
48 4) 38 gram if you are using the 
cassette loaded version of 
Applesoft. 


If an “Out of Memory" or similar error occurs when you attempt the 
link you will need to recover the link program and re-load it after a 
"RESET". "Control-B'". POKE the values given into locations 22 283, 1% 
and.77 first. This will recover the Link program. Then save it temporarily 
(NOT on top of your original Link version), and re-initialize the system 
with a "RESET", "Control-B". ("INT" if you have disk). The purpose of 
this is to move the program up in memory to make as much room as possi- 
ble for your own program when it is appended. If this still does not WOrkKk, 
you will have to delete 1 or more pictures from the series before the Link 
operation. Each picture saved uses 1K of memory. 
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When your program is finally "RUN" (be sure to re-set HIMEM: to 
your system's maximum size) the program again sets at the upper range 
of memory. 

Whenever you recall a picture, the data for that image is copied 
onto page l (or 2) of text/graphics. You may in fact even save text 
images just as you would a graphics one. The only difference is whether 
the Apple is in the TEXT or GR mode when the picture its recalled. 

Note: If you decide to use page 2 of text/graphics be sure to set 
LOMEM: to 3072 before executing the retrieval routine to avoid losing © 
variables or having the program "hang". LOMEM: may be set to 3072 
by use of the following lines: 


10 POKE 24,8: POKE 295,12: REM RESET POINTER FOR VARIABLE 
TABLE | 
20 POKE 74,8: POKE 75,12: REM RESET LOMEM: POINTER 


(From June, 1978 Contact -- APPLE Corp. user newsletter). 
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LO-RES PICTURE LINK ---APPLESOFT 


This program is for the most part identical in function and use to 
the Integer version. Because of the difference in structure of the lan- 
guages, there are a few minor variations. To use, LOAD and RUN as 
you would any usual Applesoft program. If you are using the cassette/ 
disk loaded version of Applesoft, LOAD the program, do a CALL 3314 
and then re-save the new version to run on your system. 

The addition and viewing of pictures is done in the same manner 
as the Integer Link program. After you have assembled your series of 
pictures, "L" will start the link process. All the steps you need to do 
will be displayed on the screen. 

Simply copy over each line to be entered and end with a "RETURN", 
A prompt "1" will indicate where each new line should begin, and the 
flashing cursor should appear directly over the first letter of the next 
line to be copied. (If you have a disk and DOS is active, this will all 
be done invisibly by and EXEC file which the Link program will create, 
execute, and then delete from your diskette.) Make sure there is suf- 
ficient room on the diskette for these activities. How much room will 
be required depends upon how many pictures you have collected into | 
the series. Skip the next paragraph if you do have a disk. 

The main thing to remember is to SAVE the Link program with 
assembled pictures, and then LOAD your program which will have the 
pictures appended to it. Copy over the POKEs and other data on the 
screen and finally re-LOAD the Link program with pictures. Copy over 
the last POKEs and do the "CALL" and the process is complete. You 
may now save your program in its final form. 

As in the Integer version, once the link has been completed, you 
may change any part of the listing you wish, providing the basic logic 
of operation is maintained. 

To delete the pictures and retrieval routine, enter the following 
line into the listing: 


63799 AD = PEEK(121) + 256 * PEEK(122): POKE AD +1,2: 
POKE AD + 2,8: AD =AD +3 
POKE 175,AD - INT(AD/256) * 256: POKE 176,INT 
(AD/256): END 


A "RUN" or "GOTO" to this line will delete everything including 
and after that line. This may also be used in other Applesoft programs. 


To retrieve stored pictures, the variable PIC equal to the picture 
you want must again be set, as in theInteger version. The variable NP 
must also be set early in the program with a GOSUB 638%. The retrieval 
routine starts on line #63881. The POKEs on line #63894 establish a 
machine language routine at 933 (decimal) to interface Applesoft to the 
Monitor Move routine. For purposes of speed you may delete line #63894 


LZ 


and execute the POKEs just once at the beginning of the program. If 
for some reason that series of POKEs conflicts with a routine of your 
own on the $384 page you may enter them anywhere you wish, and just 
"CALL" the starting point. 


How It Works 


Figure 9 
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The main difference between this and the Integer version is in 
memory usage. In Applesoft, programs are stored beginning at S82 
($3888 for RAM Applesoft). Each time a picture is added, it is loaded 
in at the end of the Basic program and then the end-of-program pointers 
in 175 and 176 moved to include the new data. (See fig. 5). LOMEM: 
ig set when the program first RUNs to the highest value possible to 
leave room for pictures to be added. 

An extra feature of Applesoft is that when you LIST the program, 
the additional binary data is invisible, as opposed to Integer, where 
the binary data listed out as garbage. 
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Because Applesoft programs begin at the low end of memory, your 
program must be in memory first when the retrieval routines and linked 
pictures are appended. This is why the Link program with attached pic- 
tures was SAVEd, your program LOADed into the system, and then the 
Link program appended to that, . 

When finally RUN, the complete unit will fill memory as in fig .<6:. 
Fach time a picture is recalled, the data is copied onto text/graphics 
page 1 {or 2). 


